.TH std::wmemchr 3 "2024.06.10" "http://cppreference.com" "C++ Standard Libary"
.SH NAME
std::wmemchr \- std::wmemchr

.SH Synopsis
   Defined in header <cwchar>
   const wchar_t* wmemchr( const wchar_t* ptr, wchar_t ch, std::size_t count ); \fB(1)\fP
   wchar_t* wmemchr(       wchar_t* ptr, wchar_t ch, std::size_t count );       \fB(2)\fP

   Locates the first occurrence of wide character ch in the initial count wide
   characters of the wide character array pointed to by ptr.

   If count is zero, the function returns a null pointer.

.SH Parameters

   ptr   - pointer to the wide character array to be examined
   ch    - wide character to search for
   count - number of wide characters to examine

.SH Return value

   Pointer to the location of the wide character, or a null pointer if no such
   character is found.

.SH Example


// Run this code

 #include <clocale>
 #include <cwchar>
 #include <iostream>
 #include <locale>

 int main()
 {
     const wchar_t str[] = L"诺不轻信，故人不负我\\0诺不轻许，故我不负人。";
     wchar_t target = L'许';
     const std::size_t sz = sizeof str / sizeof *str;
     if (const wchar_t* result = std::wmemchr(str, target, sz))
     {
         std::setlocale(LC_ALL, "en_US.utf8");
         std::wcout.imbue(std::locale("en_US.utf8"));
         std::wcout << "Found '" << target << "' at position " << result - str << '\\n';
     }
 }

.SH Possible output:

 Found '许' at position 14

.SH See also

   memchr      searches an array for the first occurrence of a character
               \fI(function)\fP
   strchr      finds the first occurrence of a character
               \fI(function)\fP
   wcschr      finds the first occurrence of a wide character in a wide string
               \fI(function)\fP
   find
   find_if     finds the first element satisfying specific criteria
   find_if_not \fI(function template)\fP
   \fI(C++11)\fP
   C documentation for
   wmemchr
